home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / util / moni / dboard16.readme < prev    next >
Text File  |  1993-03-22  |  6KB  |  149 lines
  1. Short: DashBoard: Shows Time,CPU,RAM with gauges and graphs
  2.  
  3.  
  4.                             The DASHBOARD
  5.                         Clock/Memory/CPU Gauge
  6.  
  7.                          by Marat Fayzullin
  8.  
  9.                        version 1.6   3/21/1993
  10.                           Copyright by FMS   
  11.  
  12.  
  13.  
  14. 1. Description
  15.  
  16.    The Dashboard is the combination of well known PerfMeter-alike
  17. utilities, clocks and RAM gauges. Its window can be opened on any
  18. public screen and displays:
  19.  
  20.               1. Current time
  21.               2. Amounts of chip, fast and total memory.
  22.               4. CPU activity.
  23.               5. Graphs of these parameters
  24.  
  25.    Here is the picture of Dashboard window:
  26.    
  27.               [*]-------------------------[#]
  28.               |[------------] [-----][-----]|
  29.               || 1          | | 3   || 4   ||
  30.               ||     -----  | [-----][-----]|
  31.               ||    /     \ |   CPU    RAM  |
  32.               ||----       -|               |
  33.               ||            | F ******==6===|
  34.               ||            | C *******=5===|
  35.               |[------------]               |
  36.               || 2 CHIP RAM |     TIME  7   |
  37.               |[------------][Feb 6 6:45:23]|
  38.               [-----------------------------]
  39.  
  40.    1. Graph of selected parameter
  41.    2. Switch selecting the parameter to graph:
  42.       CPU Idle/CPU Usage/Chip RAM/Fast RAM/Total RAM/CPU Switch
  43.    3. Gauge of CPU activity
  44.    4. Gauge of RAM usage
  45.    5. Bar showing the usage of chip RAM
  46.    6. Bar showing the usage of fast RAM
  47.    7. Current time
  48.  
  49.    Dashboard can be run either from Workbench or from CLI (you don't need
  50. to use RUN command in the last case) and only works under AmigaDOS 2 and
  51. higher. If something is wrong, Dashboard doesn't start. There are several
  52. tooltypes which can be used:
  53.  
  54. 2. History:
  55.  
  56. * Version 1.6 *
  57.  Changes: 1. Previous versions of DashBoard didn't open GadTools
  58.              library with OpenLibrary() call. Yes, I know, it
  59.              is terrible bug, such things should never happen...
  60.              Anyway, it is fixed in v1.6! Thanks to Kari E Linden
  61.              who reported this problem. 
  62.           2. There was a problem with default font. DashBoard is
  63.              supposed to display all information in topaz8, no
  64.              matter what default font is. In fact, previous versions
  65.              displayed some of things using the default font and when
  66.              it was something like times24...entire thing screwed
  67.              up or (in the best case) just looked ugly. This problem
  68.              was reported by Heikki Kantola.
  69.  
  70. * Version 1.5 *
  71.    Wasn't distributed. The only difference from v.1.4 is the GRAPH
  72. tooltype allowing to choose the parameter to be plotted on startup.
  73. This addition was suggested by Mickey Everts.
  74.  
  75. * Version 1.4 *
  76.    The weird thing appeared when DashBoard 1.2 was run with SnoopDos:
  77. On every refresh cycle DashBoard CD'ed to ENV: directory and then back
  78. to the current directory. This problem was found by Mickey Everts and
  79. (as I found later) caused by standard time() and ctime() C functions
  80. used to get current time from the system. Because I don't see any
  81. other way to get current time not hacking AmigaDOS' guts (which usually
  82. means eventual incompatibility with other DOS versions), I added special
  83. tooltype TIME=ON/OFF which turns time display on and off (obviously).
  84. For those who don't use SnoopDos, default ON value strongly recommended. 
  85.   Another problem was that DashBoard didn't display LOCAL time (well,
  86. I'm not sure if this was a problem, my clock was ok, but I concluded it
  87. from what Eric Lavitsky reported). DashBoard 1.4 should work right,
  88. although I can't check it. My A2000 runs DOS 2.04 which handles these
  89. things differently from DOS 3.
  90.   Cut down version called DashBoardJr is now included in the archive.
  91. This version draws graphs only. It doesn't display gauges and all other
  92. stuff. 
  93.  
  94. * Version 1.3 *
  95.    Wasn't distributed.
  96.  
  97. * Version 1.2 *
  98.    The first distributed version.
  99.  
  100. 3. Tooltypes:
  101.  
  102.    X=<XCoordinate>        - Coordinates of the window
  103.    Y=<YCoordinate>          ( default - 0,0 )
  104.    SCREEN=<PubScrName>    - Name of public screen to open window on
  105.    PRIORITY=<Priority>    - Priority of Dashboard between -10 and +10
  106.                             ( default - 0 )
  107.    REFRESH=<Time>         - Window refresh period expressed in 0.1
  108.                             portions of second between 1 and 100
  109.                             ( default - 10 i.e. 1 second ) 
  110.    TIME=ON/OFF/YES/NO     - Turns on/off the time display
  111.                             ( default is ON )
  112.    GRAPH=IDLE/USAGE/      - Selects the parameter to be plotted on
  113.          CHIPRAM/FASTRAM/   startup ( default is IDLE ) 
  114.          TOTALRAM/SWITCH
  115.  
  116. 4. Thanks, Copyright, Self-advertisement, Address, etc...
  117.  
  118.    Lots of thanks to Juha Tuominen from Digital Design, whose Perfmeter
  119. served as a prototype for some subroutines of Dashboard. It was Perfmeter
  120. that made me write Dashboard, mainly to find out how these things work.
  121.    Thanks to Mickey Everts who pointed out the problem with Snoopdos and
  122. made several other important suggestions.  
  123.    Dashboard is freely distributable as long as you keep executable file
  124. and this documentation together. If you like it and/or want to support
  125. the author, send $5 - $25 to the address given below. Bug reports, flames,
  126. suggestions, etc. can be sent to the same address:
  127.  
  128.                            Marat Fayzullin
  129.                      8770 Cloudleap Court Apt#24
  130.                          Columbia,  MD 21045
  131.                                  USA
  132.  
  133.               Internet E-Mail address: fms@wam.umd.edu
  134.  
  135.    Look for other great programs written by FMS (it is me, but as much
  136. as I know there are other things using this abbreviation):
  137.  
  138.           WBGames   - Set of tiny games which can be opened on
  139.                       any public screen. Current version 1.7
  140.                       includes Tetris, Columns, 15, MineSweeper,
  141.                       Sokoban and BoulderDash.
  142.           Protector - Login program like AmiStation. Supports
  143.                       multiple users and keeps log of logins.
  144. -------------------------------------------------------------------------- 
  145.                                                      Marat Fayzullin
  146.   MS-DOS: Just say NO!                                  3/21/1993
  147.                                                      fms@wam.umd.edu      
  148. --------------------------------------------------------------------------
  149.